/*
 * Copyright 2002-2019 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.beans.factory.config;

import org.springframework.beans.BeansException;

/**
 * 工厂钩子，允许自定义修改应用程序上下文的 bean 定义 ，调整上下文底层 bean工厂 的 bean属性值。
 *
 * 对于面向系统管理者的自定义配置文件很有用，这些文件会覆盖应用程序上下文中配置的bean的属性。
 *
 * BeanFactoryPostProcessor 可以与bean定义交互并修改bean定义，但是不能与bean实例交互。
 * 这样做可能会导致bean的过早实例化，违反容器规则，并导致出现意外的副作用。
 * 如果要考虑bean实例的交互，需要实现beanPostProcessor。
 *
 * ApplicationContext 在其 bean定义中自动检测 BeanFactoryPostProcessor 的bean。
 * 并在创建任何其他单实例bean之前调用他们。BeanFactoryPostProcessor 也可以通过
 * ConfigurableApplicationContext 以硬编码的方式注册。
 *
 * 在 ApplicationContext 中自动检测的 BeanFactoryPostProcessor 将根据 主排序接口和优先级接口进行排序'
 * 以硬编码方式注册的BeanFactoryPostProcessor将会根据注册的顺序进行排序，即使手动实现主排序接口或者优先级接口
 * 也会被忽略。怼了，还有@Order接口也不会生效。
 *
 *	核心一句话：在bean工厂创建完成以后对bd信息进行修改
 */
@FunctionalInterface
public interface BeanFactoryPostProcessor {

	/**
	 * 在标准初始化之后修改应用程序上下文的内部 bean 工厂。
	 * 所有 bean 定义都将被加载，但尚未实例化任何 bean。
	 * 这甚至允许覆盖或添加属性，甚至是急切初始化的 bean。
	 */
	void postProcessBeanFactory(ConfigurableListableBeanFactory beanFactory) throws BeansException;

}
